.\"-
.\" Copyright (c) 2006, 2009 Ruda Moura <ruda.moura@gmail.com>
.\"
.Dd March 24, 2009
.Dt SHUFFLE 1
.Os
.Sh NAME
.Nm shuffle
.Nd print a random permutation of the argument list
.Sh SYNOPSIS
.Nm
.Op Fl n
.Op Fl 1
.Op Ar string ...
.Sh DESCRIPTION
.Nm
prints to the standard output a random permutation of the argument list.
On supported systems, one source of entropy is /dev/random or /dev/urandom.
Knuth algorithm (in fact Fisher-Yates shuffle) is used to guarantee
truly random permutations
.Pp
The following options are available:
.Bl -tag -width Ds
.It Fl n
Do not print the trailing newline character.
.It Fl 1
Force output to be one entry per line.
.El
.Sh HISTORY
.Nm
had the initial purpose of feeding random MIDI files to playmidi.
.Sh BUGS
None until now.
